Direct Spaces Installation Guide

System requirements

Requires EMS Version 221.1 or Higher

Supported Platforms

Android

Requires Android 6.0 using Android SDK 23 or later (released October 2015)

iOS

16 or later (released September 2022)

Prerequisites

To host and install EMS Direct Spaces mobile app, you need the following:

  • EMS Database Server

  • EMS Web Server

  • EMS Platform Services

  • Mobile phones

  • Direct Spaces license

  • EMS version 225.1 or later

Authentication

iPhone iOS 14 supports default browsers for authentication via a new environment configuration. Contact your Professional Services or Support representative.

  1. Navigate to the EMS Platform Services URL. For example: https://your-environment-url.com/platform/admin#/.
  2. Sign on to your account.
  3. On the sidebar, tap the Integrations tab.
  4. Select Direct Spaces.
  5. Select the authentication method for everyday users. Direct Spaces supports these authentication methods:

Space requirements

The application requires 100MB of space on the device plus additional space for cached lists and data. Cached data space requirements typically range from 10MB to 100MB.

Network requirements

End users can access Direct Spaces using mobile clients and web browsers over wi-fi. If these wi-fi networks are protected and fire-walled, you might need to add rules to permit traffic between the clients and the cloud services used by Direct Spaces.

The Direct Spaces clients do not connect directly to the EMS API. All requests pass through an applications platform, and it requires free communication between the clients and the platform. You might need to adjust firewall rules. The required service endpoints are:

  • directspaces.app.link

  • directspaces-alternate.app.link

  • .apptreeio.com

  • .apptree.io

  • us-central1-apptreeio.cloudfunctions.net

The Direct Spaces clients use certain public cloud services that run on the Google Cloud Platform, therefore connections between the end-use device or browsers will be made to the following GCP domains:

  • .firebaseio.com

  • googleapis.com

For more restrictive access, you can whitelist specific Google API endpoints:

  • firebasestorage.googleapis.com

  • www.googleapis.com

  • play.googleapis.com

  • firestore.googleapis.com

Onboarding link

The onboarding link you receive with your Direct Spaces environment navigates users directly to the app (if already installed) or to the app store to download. The link also populates the app ID for your EMS environment, streamlining the sign-in process.

Distribute the onboarding link to everyday users and internal sites to simplify onboarding.

Reach out to your customer support manager or EMS support for your organization's onboarding link.